/*
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
package org.schema.domain.thing;

import org.schema.domain.Thing;
import org.schema.domain.thing.Organization;
import org.schema.domain.thing.creativeWork.Review;
import org.schema.domain.thing.intangible.Offer;
import org.schema.domain.thing.intangible.rating.AggregateRating;

/**
 * A product is anything that is made available for sale—for example, a pair of shoes, a concert ticket, or a car.
 */
public interface Product extends Thing {

	/**
	 * The overall rating, based on a collection of reviews or ratings, of the item.
	 *
 	 * @return AggregateRating
	 */
	AggregateRating getAggregateRating();

	/**
	 * The overall rating, based on a collection of reviews or ratings, of the item.
	 *
 	 * @param aggregateRating
	 * @return void
	 */
	void setAggregateRating(AggregateRating aggregateRating);

	/**
	 * The brand of the product.
	 *
 	 * @return Organization
	 */
	Organization getBrand();

	/**
	 * The brand of the product.
	 *
 	 * @param organization
	 * @return void
	 */
	void setBrand(Organization organization);

	/**
	 * The manufacturer of the product.
	 *
 	 * @return Organization
	 */
	Organization getManufacturer();

	/**
	 * The manufacturer of the product.
	 *
 	 * @param organization
	 * @return void
	 */
	void setManufacturer(Organization organization);

	/**
	 * The model of the product.
	 *
 	 * @return String
	 */
	String getModel();

	/**
	 * The model of the product.
	 *
 	 * @param string
	 * @return void
	 */
	void setModel(String string);

	/**
	 * An offer to sell this item—for example, an offer to sell a product, the DVD of a movie, or tickets to an event.
	 *
 	 * @return Offer
	 */
	Offer getOffers();

	/**
	 * An offer to sell this item—for example, an offer to sell a product, the DVD of a movie, or tickets to an event.
	 *
 	 * @param offer
	 * @return void
	 */
	void setOffers(Offer offer);

	/**
	 * The product identifier, such as ISBN. For example: <meta itemprop='productID' content='isbn:123-456-789'/>.
	 *
 	 * @return String
	 */
	String getProductID();

	/**
	 * The product identifier, such as ISBN. For example: <meta itemprop='productID' content='isbn:123-456-789'/>.
	 *
 	 * @param string
	 * @return void
	 */
	void setProductID(String string);

	/**
	 * Review of the item.
	 *
 	 * @return Review
	 */
	Review getReviews();

	/**
	 * Review of the item.
	 *
 	 * @param review
	 * @return void
	 */
	void setReviews(Review review);

}